home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / music_utilities / pt037.dms / pt037.adf / docs / Player40B.dox.pp / Player40B.dox
Text File  |  1989-07-26  |  8KB  |  180 lines
  1. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  2. ­                The Player 4.0B Rev 3 ®            ­
  3. -                 © 1992 Jarno Paananen            ­
  4. -             Guru of Complex and Parallax            ­
  5. ­            Official release date 3.5.1992             ­
  6. ­                Last changes: 31.5.1992            ­
  7. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  8.  
  9.     (Big thanx to Antti Toiviainen and Janne Juhola for some ideas!)
  10.  
  11. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  12. ­            A few words about distribution:         ­
  13. ­                This program is freeware            ­
  14. ­    You can distribute this as long as ALL files are included and not    ­
  15. ­        more than a nominal fee for copying is asked.        ­
  16. ­  This program cannot be used for commercial purposes without written    ­
  17. ­        permission from the author. (and little $$$ :+)         ­
  18. ­            (Also hellos are welcomed !-)
  19. ­ If you have suggestions or remarks about this program, or if you find ­
  20. ­            any bugs, please let me know.            ­
  21. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  22.  
  23. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  24. !! Update report: This is a bugfixed,optimized and MUCH improved       !!
  25. !! version of this program. Use this! This former version had a little !!
  26. !! bugs I hadn't noticed until now. Also converter is much more        !!
  27. !! user-friendly now.                               !!
  28. !!            SO THIS IS IT, ENJOY!!                   !!
  29. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  30.  
  31.     This little utility was first made just for fun and to my own use.
  32. But when I saw, that there was no a GOOD Protracker-compatible replay
  33. and after I saw Azatoth/PHA's ProPacker, I decided to give other people
  34. a chance to play their ProTracker-tunes FAST! (Original replay is terrible and
  35. NoisePacker doesn't support PT and mine is faster...:-)
  36. When I designed the moduleformat, I also decided to include a sort of packing.
  37. Quite good I would say. It was a hell of work! I worked hard to make it
  38. possible and now it seems to work correctly! [better than NoisePacker 3.0 in
  39. most cases!]
  40.  
  41.     I also made a converter to make it easier to use PT-modules. It uses
  42. REQTOOLS.LIBRARY and POWERPACKER.LIBRARY (both by Nico François) so it can
  43. also load PowerPacked ® -modules. The converter is made as easy as possible
  44. to the user. Gadgets,filerequesters,etc. I think everyone, who needs this
  45. utility, can use it, so I don't teach you how to use mouse.
  46.  
  47.     The converter first asks the module to be converted. (Can also be a
  48. converted module,it only asks you to play it) SUPPORTS BATCH-PROCESSING!
  49. (You can select multiple files to be converted!) The it loads your tune(s).
  50. If module is Powerpacked,it decrunches it first.If it was a Noise/ProTracker
  51. module, it asks the repeat position (usually 0) and you can choose the
  52. destination file (prefix P40. is already been inserted) and module is being
  53. converted and saved. You can see the statistics right after converting in
  54. a requester. Then you'll be asked do you want to hear the module played.
  55. If not it asks another module, but you surely want to hear it, so it loads
  56. the module and plays it. Also it calculates how many FULL rasterlines it
  57. takes, maximum and average lines . Max should be around 5 and average 2 or 3.
  58.     In BATCHMODE it asks the destination directory,only loads the tunes,
  59. puts repeat position to default,inserts "P40." prefix,converts and saves.
  60. In the end you can see the statistics for all of the tunes.
  61.     The replay itself is quite fast - max 4-5 :( lines - code is also
  62. quite well optimized. Uses lev6-interrupt, rest is in the source, find it
  63. out yourself.
  64.  
  65. !!!! The new packing slowed it a little bit, but we (Simply and I) optimized
  66. it quite much, so it is FASTER than P40A (one more reason to use this!)
  67. It still can jump to 6th line,but who carez?!?!?!
  68.  
  69.     Call P40_INIT with module address in A0, then P40_MUSIC every frame
  70. and P40_END to stop DMAs etc.
  71.  
  72. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  73.  
  74. Commands implemented at the moment:
  75.   - Normal NoiseTracker 2.0 commands (0-6,A-F)
  76.   - Tremolo (7), Sampleoffset (9), Fine slides (E1/E2), Set finetune (E5)
  77.     Retrig (E9), Fine volumeslides (EA/EB), Notecut (EC), Notedelay (ED)
  78.     Pattern delay (EE)
  79.   - and of course finetune...
  80.  
  81. I'll include the rest to version 4.1A (promise!)
  82.  
  83. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  84.  
  85. I'm improving this utility for my own use, but send me some $$$ and I'll
  86. send you the newest version (mention which version you have, so I don't
  87. send the same version!)
  88.  
  89.     TO:                        (no swapping!)
  90.               J.Paananen
  91.             Puskalantie 6
  92.              37120 Nokia
  93.                Finland
  94.  
  95. Or call the official Player support-board:
  96.  
  97.         BOOMTOWN    +358-31-423767        (DHST,24H)
  98.  
  99. and leave a message to me, or you can download the newest version there.
  100. Also comments,questions,remarks,bug-reports etc. are welcomed!
  101.  
  102. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  103.  
  104. History:
  105. 4.0B:        (This bugfixed,optimized and improved version!)
  106.  - Much improvements in the converter (BATCH!,Prefs,etc.)
  107.  - Some commands have changed and became faster!
  108.  - Replay is overall optimized and some BUGS! fixed (don't use rev2 if you
  109.    don't have to!) also fineslides up/down now work correctly!
  110.  - Ultra optimizing by Simply and me, now rarely jump to 6.line!
  111.  - Now uses same data, if two same samples (quite rare case, but atleast in some
  112.    chip-tunes)
  113.  
  114. 4.0A:        (First released version)
  115.  - Much more efficient packing method! (doesn't play old modules..)
  116.  - lots of little bug-hunting and improvements!
  117.  ­ those goddamn bugs drive me mad! (The packer had more bugs than a dog!)
  118.  
  119. 3.0A:        (Used in Metro II by Parallax!)
  120.  - More efficient packing method used! (Plays still 2.2A modules!)
  121.  -patterndelay is back!
  122.  -set finetune added!
  123.  -tremolo added!
  124.  -some things with replay note fixed
  125.  -arpeggio changed to command 8 (little incompatibility... but faster!)
  126.  
  127. 2.2A:        (First main version, used in Compost-loader and Metro I)
  128.  -big improvements in converter
  129.  -some improvements with notes
  130.  -BIG bugs fixed in converter
  131.  -different only sample number thing (hard to tell you..) fixed
  132.  -now works correctly with speed 1
  133.  -bug with "multiple patternbreaks in same line" fixed
  134.  -some other nasty bugs fixed
  135.  -some bugs with converter fixed
  136.  -vibratotable added
  137.  
  138. 2.1A:        (A temporary version, only for own use)
  139.  -whole player-system made again (F.A.S.T.E.R!!)
  140.  -plays still 2.0D modules
  141.  -patterndelay removed for a while
  142.  
  143. 2.0D:        (Introduction to version 2.1A, faster than 2.0C)
  144.  -module format changed a bit
  145.  -optimizing started
  146.  
  147. 2.0C:        (A major update to Protracker-compatibility)
  148.  -finetune
  149.  -sampleoffset
  150.  -notecut
  151.  -fineslide up/dwn
  152.  -finevolumeslide up/dwn
  153.  -patterndelay
  154.  -a (bug?) in toneportamento fixed
  155.  -notedelay
  156.  -retrig note
  157.  -back to safe (but slower...) routine
  158.  
  159. 2.0B:        (Ugly packer came up)
  160.  -packer
  161.  -LOTS of optimizations
  162.  
  163. 2.0A:        (First not standard moduleformat player)
  164.  -own fileformat
  165.  
  166. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  167.  
  168. 1.0A - 1.0K    (Standard module players, NT2.0 combatible)
  169. 0.*        (first experiments with Amiga's sound capabilities)
  170.  
  171. --------------------------------------------------------­­­­­­­­­­­­­­­­­
  172. Special Message to world's biggest chip-factory ESTRELLA!: [finnish text]
  173.  
  174. No niin, koska poliittinen toimintamme on osoittautunut melko tehokkaaksi,
  175. olemme päättäneet (ja jo aloittaneet!) toisen intronne hyväksikäytön.
  176. Se ei ollut vaikeaa, vaikka olittekin yrittäneet suojata kalleimpanne.
  177. Joten varautukaa...
  178.  
  179. NO CARRIER!
  180.